How to install ZenMP3 on a variety of platforms
===============================================

*Note:* you must have [Python](https://python.org) version 2.7 or newer in order to run ZenMP3. While this may be a standard in UNIX-like operating systems, very few Windows machines and only recent Mac OS X versions ship with it installed, so take care of it before you proceed. 

*Note:* `youtube-dl` is under constant updating to match the YouTube API. I recommend you to update it every week or so for ZenMP3 to work correctly.

## GNU/Linux and other UNIX-like distributions ##

Unfortunately, there are simply too many package managers for one to be able to feature detect and automate the installation process in a Linux distribution. Instead, here's the datailed procedure:

  1. Use your distribution's package manager to download and install the following packages:

  *`ffmpeg` (in Ubuntu, install `avconv` instead)
  *`youtube-dl`

  2. `git clone https://notabug.org/kzimmermann/zenmp3.git`
  3. Run the `install_unix.sh` script, located in `src`

With sufficient permissions in the machine, you can now run ZenMP3 by typing the command `zenmp3`, or running it from the applications menu.

##  Mac OS X Snow Leopard and newer ##

Since the newer Macs are standardized in the shell-level, Mac users can benefit from a single installation script. To install ZenMP3 on a Mac:

  1. Open a Terminal window.
  1. Type `svn checkout http://zenmp3.googlecode.com/svn/trunk/ zenmp3-latest` and press Enter
  1. Type `cd zenmp3-latest` and press Enter
  1. Type `bash install_mac.sh` and press Enter
  1. Follow the instructions that are prompted.

This will download all dependencies and install ZenMP3. To run ZenMP3, open a Terminal and type `zenmp3`.

## Windows ##

Is **unsupported**. Recent privacy-threatening developments with Windows 10 and overall Microsoft evildoing has had me drop any support whatsoever from this platform.

While ZenMP3 may still run quite well on Windows (I've tested it myself some years ago), I will provide no more support on installing or porting it.

Hack and fork ZenMP3 at will - that's what the GPL is for - but I myself won't be developing anything for Windows ever again..
